home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / puppy.dqc / puppy.doc
Encoding:
Text File  |  1985-03-18  |  8.1 KB  |  199 lines
  1.                    Puppy Prototype 5 Mar 85    T. Jennings
  2.  
  3.  
  4.         ITEMS MISSING FROM PUPPY AS OF 5 MAR:
  5.  
  6. Multiple file areas
  7. Configurable message categories
  8. File attach for users
  9. Questionnaires
  10.  
  11.         KNOWN BUGS AND ANNOYANCES:
  12.  
  13. Whacking CR to determine baud:
  14.         You  may  have  to   wait  one  or  two   seconds  after
  15. connecting, before you whack CR to determine the baud rate.  The
  16. new multiple baud rates required that the baud detect  circuitry
  17. change.  I'll try to repair this ASAP.
  18.  
  19.         The baud rates entered must be in INCREASING order,  and
  20. PupUp does not enforce this yet.
  21.  
  22.            ........................................
  23.  
  24.         If you somehow come across a copy of ProtoPuppy, and you
  25. are not an "official" beta site, please do NOT report errors  or
  26. make requests for changes.  Use it  if you want, but you are  on
  27. your own until it is finally released.
  28.  
  29.            ........................................
  30.  
  31. PUPPY'S MANUAL:
  32.  
  33.         This is Puppy's manual.  It  ain't much, but I think  it
  34. will  be  enough  for  a  current  Fido sysop to get Pup running
  35. completely.  There  is very  little you  will need  to know; run
  36. PupUp first, go through all the menus.  You can run Pup in  Test
  37. Mode the same as Fido: PUP /T.
  38.  
  39.         One subtle  but important  change: Pup  does not  handle
  40. paths as "filename  prefixes" as Fido  did: it uses  real paths.
  41. E.g.,  to  get  at  subdirectory  BARF  in  the  root of B:, use
  42. "B:\BARF", not "B:\BARF\".  PupUp will CREATE subdirectories for
  43. you, if they do not exist.
  44.  
  45.         As  in  Fido,  a  limit  of  zero means unlimited.  This
  46. applies to all limits, even maximum messages and users.
  47.  
  48.         WARNING: make sure that there is at least one valid baud
  49. rate set in  the baud rates  to try.  Pup  will hang forever  if
  50. not, and PupUp does not yet check for this.
  51.  
  52.  
  53.            ........................................
  54.  
  55. INCOMPATIBILITIES:
  56.  
  57.         Pup is NOT a drop  in replacement for Fido; many  things
  58. need to change.  The batch  file FIDO2PUP.BAT will make all  the
  59. filename changes.  You  will need to  use USER2PUP.EXE to  fixup
  60. the user  file to  be compatible  with Pup;  the values for help
  61. levels and privileges changed.
  62.  
  63.         The help files are  different; delete the ones  you have
  64. now.
  65.  
  66.         Please do NOT use SYSOP.EXE on USER.SYS.
  67.  
  68.         Puppy has a complete FidoNet installed; it is completely
  69. compatible.   It  has  a  few  small  inconsequential   changes:
  70. incoming mail is marked with FIDONET category, there is a  limit
  71. of  10  tries  on  no  connection  calls  out, and the limit for
  72. attempts with connect is fixed at 1.
  73.  
  74.         You can copy existing  Fido messages into a  Pup message
  75. area.  Those messages will be found in the ALL category.
  76.  
  77.            ........................................
  78.  
  79. CHANGES:
  80.  
  81.         The design criteria for Puppy vs.  Fido are as follows.
  82.  
  83.         Fido  is  incredibly   complex.   Almost  none   of  the
  84. complexity buys anything, it merely grew like mould.   Criterion
  85. #1: Radically simplify.
  86.  
  87.         Fido  has  too  many  options:  Fido  attempts to please
  88. everyone.  Criterion #2: Limit Puppy to please 90% of  everyone,
  89. and remove silliness.
  90.  
  91.         Fido  consumes  too  many  precious  resources.  Fido is
  92. nearly  useless  on  a  floppy  system,  and  there  many,  many
  93. floppy-based  Fidos.   Criterion  #3:  Set  reasonable limits on
  94. Puppy's consuming hunger.
  95.  
  96.         Fido is fairly complex  for callers to operate.   Again,
  97. too  many  options,  mostly  in  the wrong place.  Criterion #4:
  98. Strip out the deadwood commands.
  99.  
  100.         Fido is decidedly nonlinear:  the "Can't get there  from
  101. here"  syndrome.    Can't  check   for  mail,   command  parsing
  102. inconsistent, totally useless and confusing commands.  Criterion
  103. #5: Reorganization  of the  message system,  command parsing and
  104. general command structure.
  105.  
  106.         Fido  itself  is  very  large  and  bulky.   Three basic
  107. problems here: features were  tacked on, making it  difficult to
  108. connect to existing code;  installation code within Fido  itself
  109. (sysop numeric commands); and the hidden gotcha, the  incredible
  110. amount of  error checking  needed for  all this.   Criterion #6:
  111. Strip out  all unneeded  installation functions,  move the error
  112. checking outside.
  113.  
  114.         Lastly, but most  important of all,  is maintainability.
  115. I can  no longer  implement sysop  and user  requests as in days
  116. gone by; people will  just have to get  by.  There are now  200+
  117. Fidos out there, and I  get more questions, problems and  change
  118. requests than I could even answer, never mind implement.   There
  119. are bugs in Fido that I  never found; I will make no  attempt to
  120. repair them  now.  Consider  Fido as  the prototype;  as soon as
  121. Puppy is released, Fido will become "unsupported".
  122.  
  123.         Fido took four hours  to compile and link  the different
  124. versions; Puppy takes one hour.  The code is clean, having  been
  125. DESIGNED (more or less), and is once again maintainable.
  126.  
  127.         In addition, there were of course the many  enhancements
  128. everyone wanted that were impractical for Fido.
  129.  
  130.            ........................................
  131.  
  132.         Much smaller program and operating environment: the .EXE
  133. is less than 64K, should run OK in 128K with one floppy.
  134.  
  135.         Single,  unified  message  area,  with a category number
  136. embedded  in  each  message.   The  old  "R)ead" prompt has been
  137. slightly expanded, and serves for the entire message area.
  138.  
  139.         Real mail check when a caller logs on, or at any time; a
  140. separate private mail command.  No more "comments to the  sysop"
  141. area; a separate "T)oSysop" command.
  142.  
  143.         Settable limit to  the total number  of messages in  the
  144. system.
  145.  
  146.         Privilege levels are now arranged logically, instead  of
  147. by command letter.  There are  10 user privilege levels, 0  - 9,
  148. where 0 is the lowest, and 9 is sysop.  Also, there are  logical
  149. levels  of  functionality,  each  with  a  default  minimum user
  150. privilege.
  151.  
  152. 2 -- READ Access:   Can read messages, but not enter them.
  153. 3 -- ENTER access:  Messages can be entered as well.
  154. 4 -- FILE access:   Files can be downloaded, uploaded.
  155. 6 -- MAINT access:  The message purge and renumber commands,
  156.                     plus the ability to read everyones messages.
  157. 7 -- DISK access:   The ability to set temporary paths, and
  158.                     use the V)iew and K)ill commands.
  159. 9 -- SYSOP access:  All commands.
  160.  
  161.         The privilege needed to  access each level above  can be
  162. changed with PupUp.  The defaults are more or less equivalent to
  163. Fido's levels, with the exception that all users can access  the
  164. commands listed in the last line of the prompt.
  165.  
  166.  
  167.         User list almost compatible  with Fido; a fixup  program
  168. will convert from Fido to Pup.
  169.  
  170.         Pup handles  up to  four different  baud rates;  each is
  171. settable and can be anything supported by the drivers (generally
  172. 110 to 9600); defaults are 300 and 1200 only.
  173.  
  174.         User list can  be set to  a fixed number  of users; when
  175. full, new users replace the oldest NORMAL privilege caller  with
  176. no credit or debit.
  177.  
  178.         Install program (PupUp) instead of horrible command line
  179. switches.   The  only  switch  is  /T,  Test  Mode.  The install
  180. program is used to set user limits, modem type,  private/public,
  181. maximum  messages  and   users,  baud  rates,   message  length,
  182. schedules, and all other setup type parameters.
  183.  
  184.         Comments to the  sysop are addressed  to the first  name
  185. found in the user record instead of just "Sysop".
  186.  
  187.         Central command line parser.   The bad news is  that you
  188. can't do "R22" and more, thtere must be a space.  The good  news
  189. is that you can stack commands almost anywhere, such as "M C F E
  190. 51" to enter the M)essage prompt, select C)ategory F)idonet, and
  191. enter a message to Fido 51.
  192.  
  193.         A maximum number  of messages can  be set; new  messages
  194. cannot be added beyond that point until some are deleted.  It an
  195. also be unlimited as in Fido.
  196.  
  197.            ........................................
  198.            ........................................
  199.